Inside Macintosh: QuickDraw GX Objects /

Chapter 2 - Shape Objects / Shape Objects Reference

Functions / Manipulating Shape Object Properties

GXSetShapeTransform

You can use the GXSetShapeTransform function to change the transform object associated with a shape object.

void GXSetShapeTransform(gxShape target, 
                           gxTransform newTransform);

target

A reference to the shape whose transform object is to be changed.

newTransform

A reference to the new transform object to associate with the target shape.

DESCRIPTION

The GXSetShapeTransform function disassociates the transform object already associated with the target shape and disposes of it. GXSetShapeTransform then assigns the transform object referenced by the newTransform parameter to the target shape and increments by 1 the owner count of the new transform object.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
transform_is_nil
shape_access_not_allowed	(debugging version)
Notices (debugging version)
transform_already_set

SEE ALSO

The relationship of transform objects to QuickDraw GX shapes is discussed in "About QuickDraw GX Shapes" beginning on page 2-5. Transform objects themselves are further discussed in the chapter "Transform Objects" in this book.

To determine the transform object associated with a QuickDraw GX shape, use the GXGetShapeTransform function, described in the previous section.